home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / zwrite.z / zwrite
Encoding:
Text File  |  2002-10-03  |  3.3 KB  |  67 lines
  1.  
  2.  
  3.  
  4. zzzzwwwwrrrriiiitttteeee((((3333GGGG))))                                                          zzzzwwwwrrrriiiitttteeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      zzzzwwwwrrrriiiitttteeee - specifies a write mask for the z-buffer of the current
  10.      framebuffer
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      zzzzwwwwrrrriiiitttteeee((((mmmmaaaasssskkkk))))
  14.      iiiinnnntttteeeeggggeeeerrrr****4444 mmmmaaaasssskkkk;;;;
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _m_a_s_k   expects a mask indicating which z-buffer bitplanes are read only
  18.             and which can be written to.  Z-buffer bitplanes that correspond
  19.             to zeros in the mask are read only.  Z-buffer bitplanes that
  20.             correspond to ones in the mask can be written.
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      zzzzwwwwrrrriiiitttteeee specifies a mask used to control which z-buffer bitplanes are
  24.      written, and which are read only.  A separate mask is maintained by each
  25.      of the framebuffers, normal, popup, overlay, and underlay.  The mask
  26.      affects both writes to the z-buffer that are the result of z-buffer pixel
  27.      operation, and writes resulting from zzzzcccclllleeeeaaaarrrr operation.
  28.  
  29.      zzzzwwwwrrrriiiitttteeee is ignored while drawing directly to the z-buffer, as when zzzzddddrrrraaaawwww
  30.      is TRUE. In this case the current writemask applies to the z-buffer as
  31.      well as to the color bitplanes.
  32.  
  33.      zzzzwwwwrrrriiiitttteeee is initialized when a window is created, and when ggggccccoooonnnnffffiiii is
  34.      called, to enable all z-buffer bitplanes.
  35.  
  36. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  37.      gconfi, wmpack, writem, zbuffer, zdraw
  38.  
  39. NNNNOOOOTTTTEEEESSSS
  40.      Currently z-buffer operation is supported only in the normal framebuffer.
  41.      To insure compatibility with future releases of the GL, make calls to
  42.      zzzzwwwwrrrriiiitttteeee only while draw mode is NNNNOOOORRRRMMMMAAAALLLL.
  43.  
  44. BBBBUUUUGGGGSSSS
  45.      This subroutine does not function on IRIS-4D B or G models.
  46.  
  47.      IRIS-4D GT and GTX models, RealityEngine models, and the Personal Iris,
  48.      currently support a subset of z write mask functionality.  Specifically,
  49.      zzzzwwwwrrrriiiitttteeee either enables or disables the writing of all z-buffer bitplanes.
  50.      The mask passed to zzzzwwwwrrrriiiitttteeee will disable z-buffer writes if it is zero;
  51.      otherwise all z-buffer bitplanes are written.  To assure upward
  52.      compatibility with the IRIS-4D VGX and other future models, call zzzzwwwwrrrriiiitttteeee
  53.      with _m_a_s_k equal to either 0 or $FFFFFFFF when all-or-nothing update is
  54.      desired.
  55.  
  56.      On Impact and Infinite Reality individual z bitplanes are not maskable.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.